<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=utf-8">
<TITLE>
Top Level Toolbar
</TITLE>
</HEAD>
<BODY BGCOLOR="#ffffff">
<H1>Top Level Toolbar</H1>
<p>
This toolbar provides a set of controls for commonly used functionality.

<H2>Mode pulldown</H2>
This allows you to change the current <a href="../start/concepts/modes.html">mode</a>.

<H2><img src="../images/16/171.png" align="bottom" width="16" height="16" />&nbsp; New Session</H2>
This button is the same as the <a href="tlmenu/file.html">File menu</a> 'New Session' menu item.

<H2><img src="../images/16/047.png" align="bottom" width="16" height="16" />&nbsp; Open Session</H2>
This button is the same as the <a href="tlmenu/file.html">File menu</a> 'Open Session' menu item.

<H2><img src="../images/16/096.png" align="bottom" width="16" height="16" />&nbsp; Persist Session...</H2>
This button is the same as the <a href="tlmenu/file.html">File menu</a> 'Persist Session...' menu item.

<H2><img src="../images/fugue/camera.png" align="bottom" width="16" height="16" />&nbsp; Snapshot Session</H2>
This button is the same as the <a href="tlmenu/file.html">File menu</a> 'Snapshot Session' menu item.

<H2><img src="../images/16/024.png" align="bottom" width="16" height="16" />&nbsp; Session Properties...</H2>
This button is the same as the <a href="tlmenu/file.html">File menu</a> 'Properties...' menu item.

<H2><img src="../images/16/041.png" align="bottom" width="16" height="16" />&nbsp; Options...</H2>
This button is the same as the <a href="tlmenu/tools.html">Tools menu</a> 'Options...' menu item.

<H2><img src="../images/fugue/ui-tab-show.png" align="bottom" width="16" height="16" />&nbsp; Show all tabs</H2>
This button reveals all of the hidden tabs.

<H2><img src="../images/fugue/ui-tab-hide.png" align="bottom" width="16" height="16" />&nbsp; Hide unpinned tabs</H2>
This button hides all of the tabs that are 'unpinned'. Tabs can be pinned and unpinned via the small 'pin' icon that is shown when the tab is selected.

<H2><img src="../images/ui_tab_text.png" align="bottom" width="16" height="16" />&nbsp; Show tab names and icons</H2>
This button toggles the displaying of the tab names.

<H2><img src="../images/expand_sites.png" align="bottom" width="16" height="16" />&nbsp; Expand Sites Tab</H2>
This changes the display so that the 'tree' window containing the Sites tab extends for the full length of the 
left hand side.<br>
This will reduce the amount of space available to the 'information' window.

<H2><img src="../images/expand_info.png" align="bottom" width="16" height="16" />&nbsp; Expand Information Tabs</H2>
This changes the display so that the 'information' window extends for the full length of the bottom.<br> 
This will reduce the amount of space available to the 'tree' window.

<H2><img src="../images/expand_full.png" align="bottom" width="16" height="16" />&nbsp; Full Layout</H2>
This changes the display so that the selected tab takes up the full screen.<br> 
This is useful when using ZAP on small screens.

<H2><img src="../images/layout_tabbed.png" align="bottom" width="16" height="16" />&nbsp; Request and Response tabs side by side</H2>
This changes the display so that the request and response tabs are side by side.<br> 
This increases the information that can be displayed but means you cannot see both the request and response at the same time.

<H2><img src="../images/layout_tabbed_split.png" align="bottom" width="16" height="16" />&nbsp; Request and Response panels side by side in the same tab</H2>
This changes the display so that the request and response panels are shown side by side in the same tab.<br> 
This decreases the information that can be displayed but means you can see both the request and response at the same time.

<H2><img src="../images/layout_vertical_split.png" align="bottom" width="16" height="16" />&nbsp; Request shown above Response</H2>
This changes the display so that the request panel is shown above the response panel.<br> 
This decreases the information that can be displayed but means you can see both the request and response at the same time.

<H2><img src="../images/layout_horizontal_split.png" align="bottom" width="16" height="16" />&nbsp; Request and Response panels side by side</H2>
This changes the display so that the request panel is shown to the left of the response panel.<br> 
This decreases the information that can be displayed but means you can see both the request and response at the same time.


<H2><img src="../images/16/152.png" align="bottom" width="16" height="16" />&nbsp;/&nbsp;
<img src="../images/16/151.png" align="bottom" width="16" height="16" />&nbsp;
Set / Unset break on all requests and responses</H2>
This sets and unsets a 'global' <a href="../start/concepts/breakpoints.html">break point</a> that will
trap and display the next request or response in the <a href="tabs/break.html">Break tab</a>.<br/>
You can then change any part of the request or response that you want to and send it to the target
application by pressing either of the 'Step' or 'Continue' buttons.<br/>
Alternatively you can press the 'Drop' button to dispose of the request or response.<br/>
You can switch between a single 'combined' break button and separates ones for requests and responses via the 
<a href="dialogs/options/breakpoints.html">Options breakpoints screen</a>

<H2><img src="../images/16/105.png" align="bottom" width="16" height="16" />&nbsp;/&nbsp;
<img src="../images/16/105r.png" align="bottom" width="16" height="16" />&nbsp;
Set / Unset break on all requests</H2>
This sets and unsets a 'global' <a href="../start/concepts/breakpoints.html">break point</a> that will
trap and display the next request in the <a href="tabs/break.html">Break tab</a>.<br/>
You can then change any part of the request that you want to and send it to the target
application by pressing either of the 'Step' or 'Continue' buttons.<br/>
Alternatively you can press the 'Drop' button to dispose of the request.<br/>
You can switch between a single 'combined' break button and separates ones for requests and responses via the 
<a href="dialogs/options/breakpoints.html">Options breakpoints screen</a>

<H2><img src="../images/16/106.png" align="bottom" width="16" height="16" />&nbsp;/&nbsp;
<img src="../images/16/106r.png" align="bottom" width="16" height="16" />&nbsp;
Set / Unset break on all responses</H2>
This sets and unsets a 'global' <a href="../start/concepts/breakpoints.html">break point</a> that will
trap and display the next response in the <a href="tabs/break.html">Break tab</a>.<br/>
You can then change any part of the response that you want to and send it to your browser
by pressing either of the 'Step' or 'Continue' buttons.<br/>
Alternatively you can press the 'Drop' button to dispose of the request.<br/>
You can switch between a single 'combined' break button and separates ones for requests and responses via the 
<a href="dialogs/options/breakpoints.html">Options breakpoints screen</a>

<H2><img src="../images/16/143.png" align="bottom" width="16" height="16" />&nbsp; Step</H2>
This allows the trapped request or response to continue to the application or your browser
with any changes that you have made to it.<br/>
The 'global' <a href="../start/concepts/breakpoints.html">break point</a> will remain set so that
the next request or response will also be caught.<br/>
This button is only enabled when a request or response is trapped.

<H2><img src="../images/16/131.png" align="bottom" width="16" height="16" />&nbsp; Continue</H2>
The 'global' <a href="../start/concepts/breakpoints.html">break point</a> will be unset so that
subsequent requests and responses will no longer be caught by ZAP unless you have set break points on specific URLs.<br/>
This button is only enabled when a request or response is trapped.

<H2><img src="../images/16/150.png" align="bottom" width="16" height="16" />&nbsp; Drop</H2>
This drops the trapped request or response so that it is not passed on to the application
or your browser.<br/>
This button is only enabled when a request or response is trapped.

<H2><img src="../images/16/break_add.png" align="bottom" width="16" height="16" />&nbsp; Add a custom HTTP break point</H2>
This displays the <a href="dialogs/addbreak.html">Add break point</a> dialog which allows you to specify the criteria for a 
<a href="../start/concepts/breakpoints.html">break point</a>.

<H2><img src="../images/fugue/equalizer.png" align="bottom" width="16" height="16" />&nbsp; Scan Policy Manager...</H2>
Shows the <a href="dialogs/scanpolicymgr.html">Scan Policy Manager</a> dialog which allows configuration of <a href="../start/concepts/scanpolicy.html">scan policies</a>.

<H2><img src="../images/fugue/block.png" align="bottom" width="16" height="16" />&nbsp; Manage Add-ons</H2>
This shows the <a href="dialogs/manageaddons.html">Manage Add-ons</a> dialog which allows you to
discover, install and update add-ons from the online marketplace.<br/>
It also allows you to uninstall add-ons.

<H2><img src="../images/fugue/forcedUserOff.png" align="bottom" width="16" height="16" />&nbsp;/&nbsp;
<img src="../images/fugue/forcedUserOn.png" align="bottom" width="16" height="16" />&nbsp;
Forced User Mode On / Off</H2>
This switches forced user mode on and off.<br/>
The button is only enabled when you have defined a forced user for at least one 
<a href="../start/concepts/contexts.html">context</a>, which can be done via the 
<a href="dialogs/session/contexts.html">Session Contexts</a> dialog.

<p>
Note that <a href="../start/concepts/addons.html">add-ons</a> can add additional buttons.
</p>

<H2>See also</H2>
&nbsp;&nbsp;&nbsp;&nbsp;<a href="overview.html">The user interface overview</a><br/>
<table>
<tr><td>&nbsp;&nbsp;&nbsp;&nbsp;</td><td>
<a href="../start/start.html">Getting Started</a></td><td>for details of how to
start using ZAP</td></tr>
<tr><td>&nbsp;&nbsp;&nbsp;&nbsp;</td><td>
<a href="dialogs/dialogs.html">Dialogs</a></td><td>for details of the dialogs or popups </td></tr>
<tr><td>&nbsp;&nbsp;&nbsp;&nbsp;</td><td>
<a href="../intro.html">Introduction</a></td><td>the introduction to ZAP</td></tr>
</table>

</BODY>
</HTML>
